package com.weai.service;

import com.weai.dto.AuthResponse;
import com.weai.dto.LoginRequest;
import com.weai.dto.RegisterRequest;
import com.weai.dto.UserDTO;
import com.weai.entity.User;

import java.util.List;

/**
 * 用户服务接口
 */
public interface UserService {
    
    /**
     * 注册新用户
     *
     * @param request 注册请求
     * @return 认证响应（包含令牌和用户信息）
     */
    AuthResponse register(RegisterRequest request);
    
    /**
     * 用户登录
     *
     * @param request 登录请求
     * @return 认证响应（包含令牌和用户信息）
     */
    AuthResponse login(LoginRequest request);
    
    /**
     * 获取所有用户
     *
     * @return 用户列表
     */
    List<UserDTO> findAll();
    
    /**
     * 根据ID查找用户
     *
     * @param id 用户ID
     * @return 用户DTO
     */
    UserDTO findById(Long id);
    
    /**
     * 根据英文名查找用户
     *
     * @param englishName 英文名
     * @return 用户DTO
     */
    UserDTO findByEnglishName(String englishName);
    
    /**
     * 更新用户信息
     *
     * @param id      用户ID
     * @param userDTO 用户DTO
     * @return 更新后的用户DTO
     */
    UserDTO update(Long id, UserDTO userDTO);
    
    /**
     * 删除用户
     *
     * @param id 用户ID
     */
    void delete(Long id);
    
    /**
     * 将用户实体转换为DTO
     *
     * @param user 用户实体
     * @return 用户DTO
     */
    UserDTO toDto(User user);
    
    /**
     * 将DTO转换为用户实体
     *
     * @param userDTO 用户DTO
     * @return 用户实体
     */
    User toEntity(UserDTO userDTO);
    
    /**
     * 获取所有用户的英文名和中文名
     *
     * @return 用户名称列表，格式为englishName/chineseName
     */
    List<String> findAllUserNames();
} 